Skip to content

docs(web): update README with shipped routing/pages/context; expand CHANGELOG Web bullet#20

Closed
cursor[bot] wants to merge 1 commit into
mainfrom
cursor/codebase-documentation-alignment-f810
Closed

docs(web): update README with shipped routing/pages/context; expand CHANGELOG Web bullet#20
cursor[bot] wants to merge 1 commit into
mainfrom
cursor/codebase-documentation-alignment-f810

Conversation

@cursor

@cursor cursor Bot commented May 2, 2026

Copy link
Copy Markdown

Summary

Keep web/README.md and CHANGELOG.md aligned with the app shell routing that shipped in commit 8f35e9a590db.

Why

The web/README.md still described React Router as a future "PR C — Optional" item, even though HashRouter, three named pages, TimelineRefreshContext, and full API helpers had already landed. Contributors reading the file got a misleading picture of the current codebase.

Changes

web/README.md — replaced the stale "PR split / Suggested follow-ups" section with an "App structure" section covering:

  • HashRouter with a route/URL hash/component/nav-label mapping table (clarifies that nav "Promote" = route /#/actions = ActionsPage, not a literal /promote route)
  • Page-by-page descriptions: OverviewPage (read+auto-refresh), DiffPage (diff form + metrics), ActionsPage (promote/rollback mutations)
  • API helpers in api.ts (fetchJson, loadTimeline, type exports)
  • TimelineRefreshContext pattern and mutation flow

CHANGELOG.md — expanded the Unreleased "Web + E2E" bullet to name HashRouter, three hash routes, TimelineRefreshContext mechanics, and Playwright smoke coverage scope.

Validation

  • uv sync --frozen --extra dev
  • uv run python -m ruff check src tests — clean
  • No Python, schema, or static bundle changes; only Markdown docs were modified.
  • uv run python -m pytest
  • uv run flightdeck-quickstart-verify
  • uv run flightdeck --help

Schema / Storage Impact

  • None

Risk

Documentation-only. No code paths changed.

Review

  • PR is small and scoped to two Markdown files; no behavior change.
Open in Web View Automation 

…pand CHANGELOG Web bullet

- Replace stale 'PR split / suggested follow-ups' section in web/README.md with
  accurate architecture docs covering the shipped HashRouter setup, three named
  pages (OverviewPage, DiffPage, ActionsPage), API helpers in api.ts, and the
  TimelineRefreshContext pattern.

- Add route/URL/component/nav-label mapping table so contributors know that the
  'Promote' nav link maps to /#/actions and ActionsPage, not a literal /promote route.

- Expand the CHANGELOG Unreleased 'Web + E2E' bullet to name HashRouter, the
  three pages with their hash routes, TimelineRefreshContext mechanics, and
  Playwright smoke coverage.

Co-authored-by: Gottam Sai Bharath <Gsbreddy@users.noreply.github.com>
@Gsbreddy Gsbreddy closed this May 2, 2026
@Gsbreddy Gsbreddy deleted the cursor/codebase-documentation-alignment-f810 branch May 2, 2026 11:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants